home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr29 / fileb202.zip / FILEBAR.TXT < prev    next >
Text File  |  1995-04-04  |  45KB  |  889 lines

  1. ===============================================================================
  2. -------------------------------------------------------------------------------
  3.            
  4.                  FileBar - Version 2.02
  5.         
  6.         An OS/2 Application Launch Facility and WPS Replacement
  7.        Written By Eric A. Wolf - Copyright (C) 1995 - All Rights Reserved
  8.  
  9. -------------------------------------------------------------------------------
  10. ===============================================================================
  11.  
  12.  
  13.  
  14. == Introduction ============
  15.  
  16. FileBar, quite simply, is a menubar for your desktop.  It is intended to ease 
  17. the operation of launching frequently used applications and from jumping from 
  18. task to task within OS/2.  Spanning across the top or bottom of your desktop, 
  19. FileBar is intended to give you quick and easy access to your most used 
  20. applications (whether they are DOS, Windows or OS/2 applications).  
  21.  
  22. With FileBar, you have eight menus in which you can place a maximum of 38 
  23. different items in each.  With FileBar 2.xx, menu items may also be grouped 
  24. via the use of sub-menus, a great way to organize your applications.  With
  25. submenus (each menu item can be a menu of 38 additional items), a user may 
  26. have over 10,000 total menu items!  
  27.  
  28. Each menu item may represent a command shell to boot, a script file to 
  29. perform a task or even your favorite application.  With FileBar, you're just 
  30. one click away from your favorite and most used programs (DOS, OS/2 or 
  31. Windows programs).  Also, FileBar can be used as a regular application or you 
  32. can use it to replace your existing Workplace Shell.  
  33.  
  34. If you feel OS/2 is too slow or swaps to disk a lot, FileBar may be what you
  35. need.  When acting as a replacement shell, because of its small size, FileBar 
  36. can give back two to three megabytes of memory to your system for use 
  37. with other applications.  This results in a faster system since swapping
  38. to disk is less frequent.
  39.  
  40. This program is ideal for network situations where network drivers use vast
  41. amounts of precious memory or in portable computers with limited memory.  
  42. FileBar also allows password protection and system administrator access 
  43. features for network or group access restriction situations.
  44.  
  45.  
  46. -------------------------------------------------------------------------------
  47.  
  48. == Installation ============
  49.  
  50.    (FileBar 2.xx's new  configuration  file format is not compatable with) 
  51.    (earlier versions of FileBar.  So, even if you are  a previous user of) 
  52.    (FileBar, you will need to proceed through the following instructions.)
  53.  
  54. Installing FileBar is simple.  Read the README file and once you agree to
  55. register the product if you continue to use it, unzip the second zipfile,
  56. FILEBAR.ZIP.  Now, simply go to an OS/2 prompt, and type INSTALL from the
  57. same directory where you unzipped the files.  That will invoke a REXX script
  58. that will create a FileBar program object/icon on your OS/2 desktop for you 
  59. to use to start FileBar.  
  60.  
  61. To immediately start FileBar, double click the program object on the
  62. desktop.  And to make FileBar start every time you boot OS/2, drag the
  63. object (or a copy or shadow thereof) to the startup folder that is found in
  64. the OS/2 system folder.
  65.  
  66. (NOTE:  You should proceed to unzip the second zipfile ONLY if you agree to
  67.     the registration requirements presented both in the README file and
  68.     in the registration text at the end of this document.)
  69.  
  70. If you are upgrading from a previous version of FileBar, you will need to
  71. completely erase the current version of FileBar first.  If you are using 
  72. FileBar 2.00 or greater, you may keep your configuration files and your
  73. registration code (*.reg).  All other files must be removed before
  74. installing a new version.
  75.  
  76. Installing FileBar as a WPS replacement:
  77. ----------------------------------------
  78. FileBar has the capability to be used as a replacement shell.  This means,
  79. instead of using the Workplace Shell (furhter abbreviated WPS in this text) 
  80. which is your familiar "desktop" that comes with your OS/2 system, you can 
  81. use FileBar.  Doing this greatly reduces the amount of memory OS/2 requires 
  82. and can give your programs an extra two and to three megabytes of memory (on 
  83. average) to run in.  This results in *very* noticeable speed increases on 
  84. most systems.
  85.  
  86. If you wish to use FileBar over the WPS as your shell, simply edit your
  87. OS/2 config.sys and change the line that reads:
  88.  
  89.   SET RUNWORKPLACE=PM_Shell_Path\PMSHELL.EXE 
  90.   
  91.    to
  92.  
  93.   SET RUNWORKPLACE=Put_Complete_FileBar_Path_Here\FILEBAR.EXE
  94.  
  95. For example, if you installed FileBar in a directory on your C: drive called
  96. \OS2\APPS\FILEBAR and your OS/2 system is installed on drive D:, then you
  97. would edit your config.sys file by typing the line: e d:\config.sys <enter>. 
  98. Then, you would find the SET RUNWORKPLACE= line in that file and change it to 
  99. the following:
  100.   
  101.      SET RUNWORKPLACE=C:\OS2\APPS\FILEBAR\FILEBAR.EXE
  102.  
  103.  
  104. (**NOTE:** DO NOT modify the PROTSHEL setting in the OS/2 config.sys!!)
  105.  
  106. Also, you will need to copy the FILEBAR.DLL file to your \OS2\DLL directory.
  107. (This is necessary only if you are running FileBar as a WPS replacement.)
  108. You will also need to add the directory where FileBar is located to your
  109. OS/2 path.  (See the OS/2 documentation for full details on adding things
  110. to your path).
  111.  
  112. After doing both of these things, the next time you boot OS/2, you will
  113. have FileBar as your shell.  To change back to WPS, simply change the line
  114. back to PMSHELL.  You may switch between PMSHELL and FileBar as often as you 
  115. like.  There is no harm in switching.
  116.  
  117. Please note that replacing the Workplace Shell will no longer give you access
  118. to folders or objects.  These are both entities of the WPS and are not
  119. accessible without it.  If you need these objects on a continual basis, please
  120. use FileBar in conjunction to your WPS desktop.  If you need objects/folders 
  121. on a limited basis, use FileBar as your shell while using WPS only when you 
  122. need it (WPS can be launched as an application from the FileBar menubar); by 
  123. using FileBar, you will save A LOT of memory.
  124.  
  125.  
  126. -------------------------------------------------------------------------------
  127.  
  128. == Using FileBar =============
  129.  
  130. Once FileBar is started, you will see the FileBar across the top of your
  131. screen.  You access functions in FileBar like any other menubar that is in 
  132. any other OS/2 application.  The menubar may be positioned at the top or the
  133. bottom of your desktop (see the instructions below on moving it).  The current
  134. time and or date may also be displayed on the FileBar for convenience (again,
  135. see below for details) in addition to many other features.  See below for
  136. details on all available functions in FileBar.
  137.  
  138. The first time you boot FileBar, it comes preconfigured with several menus.
  139. The first two, FileBar and Task List are static (that is, unchangable by the
  140. user) but the remaining menus may be added to, changed or even deleted and
  141. replace by more of your own menus.
  142.  
  143. The functions available to you via the first two (static) menus of FileBar
  144. are explained below:
  145.  
  146. FileBar Menu
  147. ------------
  148.    OPEN:  In FileBar, you can set up menus and options to your liking.  Often
  149.       times, it is convenient to keep multiple sets of menus and options
  150.       (perhaps for different users on a single machine).  You will use
  151.       this option to open different configuration files.  FileBar 2.xx
  152.       configuration files usually end in the .INI suffix.  Use the
  153.       file selection dialog to select a new configuration file to use or
  154.       select cancel to abort the operation.
  155.    
  156.    SAVE:  Whenever you make changes to your FileBar menu structure or change
  157.       FileBar options, you will want to save those options to the current
  158.       configuration file.  Use this option to do this.  Even though your 
  159.       configuration file will be saved whenever FileBar is closed or, 
  160.       optionally, whenever you load a new configuration file, it is wise
  161.       to save whenever you are making changes.  
  162.  
  163.    SAVE AS:  This command operates very is identically to the save command 
  164.          above except it allows you to specify the file name to save to
  165.          rather than using the currently opened file name.  
  166.  
  167.    LOCKUP SYSTEM:  This command allows you to lock your computer; thus, 
  168.            preventing use from unauthorized users.  When invoked,
  169.            the screen will darken except for a single password
  170.            dialog.  Your computer will be locked (unable to perform
  171.            any actions) until the appropriate password is entered
  172.            in the dialog.  This password used is set via the System 
  173.            Administrator Password option in the Options... menu
  174.            (see below).  
  175.  
  176.            To avoid screen burn-in, the lockup dialog will reposition
  177.            itself on your screen every 5 minutes.  This way, you
  178.            can lockup your computer leaving your monitor on and
  179.            leave it knowing it is safe from both other users and 
  180.            harmful screen burn-in.
  181.  
  182.    EDIT MENUS:  This topic is too long to cover in this context.  A special
  183.         section below, "Editing FileBar Menus", can be found below 
  184.         which discusses this topic in detail.
  185.  
  186.    OPTIONS:  There are seven option menus that cascade off this menu choice.
  187.          See "FileBar Options" below for information on each of these
  188.          different selections and what each provides.
  189.  
  190.    WORK AREAS:  FileBar 2.xx allows users to have a virtual desktop that is
  191.         9 screens large arranged in a 3 x 3 array.  When you start 
  192.         FileBar, when work areas are enable via the options menu, 
  193.         you start in area #1 (upper-left hand corner of
  194.         3x3 grid).  Selecting a new area will move you to that 
  195.         virtual area.
  196.  
  197.         See the Work Areas Option item in the "FileBar Options"
  198.         below for information on how to configure virtual work areas.
  199.  
  200.    PRINT SPOOLER:  Since OS/2's WPS provides a print spooler of its own, this
  201.            item is usually only useful when FileBar is acting as your
  202.            shell (see above for how to make FileBar your replacement
  203.            shell).  When selected, a print spooler representing all
  204.            your output devices (printers, faxes, etc.) appear as in 
  205.            dialog on your screen.
  206.  
  207.            From here, you can select either entire print queues or
  208.            individual jobs.  Queues can be paused and resumed while 
  209.            individual print jobs can be paused, resumed, and deleted.
  210.            
  211.            While the spooler will update itself every 5 seconds, 
  212.            clicking the refresh button will force the dialog to 
  213.            update its contents immedialtely.  Clicking the Dismiss
  214.            button will remove the dialog from your screen.
  215.  
  216.    ABOUT:  This option provides you information about the version and author
  217.        of FileBar.  If you have not yet registered FileBar to the
  218.        full version, this dialog gives you the oppurtunity to do so.
  219.        
  220.        After dismissing the about dialog, you will be presented with
  221.        a dialog that will allow you to register FileBar 2.xx.  Once you
  222.        register (see below), you will be given the information necessary
  223.        to fill in the three entry fields in the registration dialog.
  224.        Once you fill in the dialog with valid information, click the
  225.        Register Now button.  If you have not yet registered, click the
  226.        I'll Register Later button.
  227.        
  228.        Once you register FileBar, information about you will appear in
  229.        the about dialog to show the world you are a proud, registered
  230.        user of FileBar 2.xx!  Once you register, the registration dialogs
  231.        no longer appear.
  232.  
  233.    EXIT:  This command saves your current menu configuration file and closes
  234.       FileBar.  This option is not available while FileBar is a 
  235.       replacement shell.  The only way to close FileBar in that case is
  236.       to shutdown your system (see Task List menu below).
  237.  
  238.  
  239. Task List Menu
  240. --------------
  241.    TASK LIST:  The tasklist menu, whenever "pulled down", shows a list of all
  242.            the currently running applications on your system.  From this
  243.            menu, you can perform a number of different options.  Simply
  244.            selecting the application name will jump to that application;
  245.            giving control to it and restoring it if necessary.
  246.            
  247.            Each running application can be switched to, closed, 
  248.            maximized, minimized, hidden or shown using the cascading menu 
  249.            to the right of each item.  
  250.  
  251.    SHUTDOWN SYSTEM:  It is required of OS/2 (and most advanced operating)
  252.              systems that you not simply just turn off your computer 
  253.              when are done using it.  You need to tell the system 
  254.              you are through so it can save any open system files, 
  255.              flush the disk cache, and generally clean itself up 
  256.              before quitting.  Use this option to signal that you
  257.              are done using OS/2 and wish to be able to reset or 
  258.              turn off your computer.
  259. User Defined Menus
  260. ------------------
  261. Each item in a user defined menu may be launched (started) by selecting it.
  262. The item will be launched with the data as defined in the edit item dialog
  263. (see See the "Editing FileBar Menus" section below).
  264.  
  265. User menu items may be edited by selecting them with the right mouse button.
  266. Click and hold the right mouse button over the menu you want.  Slide the 
  267. mouse to the item you want to edit (still holding the right mouse button)
  268. and then release it.  You will now be able to edit it.  Note that this is
  269. only available when FileBar is displayed across the top or bottom of your
  270. desktop.  If using FileBar as a popup menu, you must use the edit item
  271. command under the FileBar menu.
  272.  
  273. The contents of user menus can be modified.  See the "Editing FileBar
  274. Menus" section below.
  275.  
  276.  
  277. -------------------------------------------------------------------------------
  278.  
  279. == VIRTUAL WORK AREAS ========
  280.  
  281. The "Virtual work areas" feature of FileBar 2.xx allows users to maintain
  282. a desktop much larger than their single physical display.  FileBar gives
  283. you 9 "virtual" work areas.  These work areas are like separate displays
  284. which share the same background and icons.
  285.  
  286. Virtual work areas are arranged in a 3x3 grid.  Items may be moved from one
  287. area to another by sliding a window half way off the screen in the direction
  288. you want it to go, selecting the new work area and then grabbing the half
  289. of the displayed window and moving it into the desired position.
  290.  
  291. How can I use virtual work areas?
  292. ---------------------------------
  293. Say you are at home and have your word processor, spreadsheet and a game
  294. program running.  If you like to view both your word processor and your
  295. spreadsheet but want to avoid having to mess with minimizing and restoring
  296. applications, they you can launch your word processor in one area and launch
  297. your spreadsheet in another.  You can flip quickly between them by selecting
  298. the work area each are in.  And your game program we mentioned is all the
  299. while running in a 3rd area.  So, when someone comes in, you can quickly 
  300. switch back to your spreadsheet or word processor and people may believe you 
  301. are actually at work!  :)
  302.  
  303.  
  304. -------------------------------------------------------------------------------
  305.  
  306. == EDITING FILEBAR MENUS ====
  307.  
  308. FileBar's main feature is the ability for users to easily set up menus so 
  309. they can access their applications easily and quickly.  In this section,
  310. how to set up menus will be addressed.
  311.  
  312. Editing Top-Level Menus
  313. -----------------------
  314. To add, remove or edit your existing menus, select the "Edit Menus" item
  315. from the FileBar menu.  This will bring up the edit menu dialog.  From here,
  316. you can move menus left or right on your menu bar by clicking the Move 
  317. Menu < or Move Menu > options.  You may remove an entire menu, including all
  318. the items it contains by clicking remove menu.  Removing a menu will remove
  319. all the items in the menu -and- all the submenus (and their items) in a given
  320. menu structure.
  321.  
  322. You can add a menu by selecting the add menu button.  Simply type in the name
  323. of the menu you wish to add and press enter.  Remember that you are limited
  324. to a total of eight user defined menus.  You may have no more than eight
  325. user defined menus on your FileBar (although you may have many, many
  326. submenus!).  You may edit the contents of any menu by double clicking a
  327. menu with the left mouse button.  Or, another way to edit a menu is to
  328. select it and click the edit menu button.  Editing menu items are discussed
  329. below.
  330.  
  331. Editing Menu Contents
  332. ---------------------
  333. After you selected a top-level menu to edit, you will be presented with a
  334. new dialog that lists that menus contents.  Here, similar to the top-level
  335. menu dialog, you can move items up and down in the menu structure.  You
  336. can also delete items (deleting a submenu will delete all items that
  337. submenu contains!).  
  338.  
  339. In menus, you can add separator lines, as well.  These lines are used
  340. as dividers, primarily, and are useful in providing another level of
  341. organization in your menus.  You can separators to your menus via the
  342. add separator button.  
  343.  
  344. A powerful features of FileBar 2.xx is the ability to add submenus.  
  345. Submenus act like and are treated just like regular menus.  To add a
  346. submenu, click the add submenu button and enter a title for your
  347. submenu.  After doing so, you will get a new, blank menu to fill.
  348. Submenus can be moved, added and deleted just like regular 
  349. individual items (see below).
  350.  
  351. You can also add individual menu items (see editing individual menu
  352. items below).  This is how you will add your own applications to
  353. the FileBar.  For more details on adding or editing individual menu
  354. items, please see the next section.
  355.  
  356. You may edit the contents of any individual menu item by double clicking
  357. the desiried item with the left mouse button.  Or, another way to edit an
  358. individual menu item is to select it and click the edit item button.
  359. Editing individual menu items are discussed below.
  360.  
  361. Editing Individial Menu Items
  362. -----------------------------
  363. This section is useful in adding, removing or editing menu item entries in
  364. a menu,  As mentioned above, you may edit a menu item by selecting it from
  365. the edit menu dialog.  Or, you may also edit a single menu item by holding 
  366. the right mouse button over the menu of the item you wish to edit (this 
  367. is not available when FileBar is activated via the pop-up menu).  Still 
  368. holding the button, drag the cursor down to the item you want to edit and 
  369. release the button.  You may now edit this item just as if you had selected 
  370. it using the Edit Menus item.
  371.  
  372. When editing a menu item, you will see a dialog with many options.  The
  373. first is the item's title.  You may enter a title for the item you wish
  374. to enter (this title will be displayed in the FileBar as the item text for
  375. this item).  You may edit this text at any time.
  376.  
  377. Next, below the title, is the Item Session Type area.  Here you will
  378. specify the type of application you want to add.  If the program is an
  379. OS/2, DOS or Windows session (and windowed or full-screen), click the
  380. appropriate choice.  If you are running a Windows application, you
  381. also have the additional options of running the application in a
  382. separate Windows session and/or running it in Windows 386/enhanced
  383. mode.  See your IBM OS/2 Warp documentation for more details on what
  384. these actually mean.
  385.  
  386. Below the session type area, is the Item Startup Options area.  Here, you
  387. can tell FileBar whether to start the specified application minimized,
  388. maximized, or whether or not you want this program started everytime you
  389. start FileBar.  (See the Startup List Options entry under the Options...
  390. Section above for more details on what this means). 
  391.  
  392. To the right of the session type information is the passwording 
  393. information.  If you wish to password protect the starting of this item,
  394. check the password checkbox.  You will also need to click the Change
  395. Password button to set a password for this item.  If you do not do this,
  396. your default password is 'filebar' (7 letters, all lowercase).  Using
  397. this option helps protect various programs from being launched by just
  398. anyone on your computer.  The correct password will be needed before
  399. they can launch this item.  If you wish to also password protect
  400. editing menu items, see System Administrator Options above.
  401.  
  402. Below the password information is the information regarding the
  403. application you are setting up.  The first field, "Pgm Path" specifies
  404. the complete path to the application you wish to execute when this
  405. menu item is selected.  The "Arguments:" field specifies any
  406. command line arguments you need to specify for the application.
  407.  
  408. If you need to specify arguments at run-time, enter those parameters
  409. on the argument line enclosed in braces.  For example, if you have a
  410. telnet client that always runs on port 4523 but connects to many
  411. hosts, you may construct your Arguments: entry as:
  412.  
  413.         [enter host] 4523
  414.  
  415. This will prompt the user to enter the first parameter at run time (with
  416. the prompt 'enter host') and using 4523 as the second command line
  417. parameter.  Any number of arguments can be specified at run-time and
  418. you are free to intermix static and dynamic command line arguments.
  419.  
  420. The "Directory:" field points to the default directory this application 
  421. should be started in.
  422.  
  423. The settings button will be described below in the DOS Settings section.
  424. The Find File button, under the entry fields, allows you to easily 
  425. location an application you want to define.  Click find file and you
  426. will be presented with a file finder dialog.  Traverse the file system
  427. and select a *.BAT,*.CMD,*.COM,*.EXE or similar executable to use as
  428. the application to launch.  Once you select an application, all 
  429. relevant information about the application will be filled in for you.
  430. You probably would want to change the item title, however.  Also, you
  431. want to be sure the session type is correctly defined (automatic
  432. sensing is not always what it is cracked up to be!)
  433.  
  434. Opening WPS Objects
  435. -------------------
  436. Below the two buttons is a drag and drop area.  Here, you can drag and
  437. drop WPS objects you wish to open via FileBar.  WPS objects can only
  438. be opened when FileBar is NOT the replacement (when you replace the
  439. WPS, WPS objects are gone, too!)
  440.  
  441. To use this feature, simply drag a copy of the WPS object you want to
  442. open to the rectangular area marked on the dialog and drop it.  The 
  443. dialog will then configure itself to open that object whenever the 
  444. menu item is selected.  Once you drop the object, simply click OK 
  445. because the settings are correct.  You may also click the 
  446. settings button to modify the WPS settings for that object.
  447.  
  448. DOS Settings
  449. ------------
  450. If you are setting up a DOS or Windows application, and you want to 
  451. specify specific DOS settings for this application, you will need to
  452. use the Settings: field on the edit individual menu item dialog.
  453.  
  454. To use settings, first enter a unique pathname into the settings field.
  455. This should be a filename which does not currently exist on your 
  456. computer.  Settings files can reside anywhere on your file system but 
  457. are often useful if placed with the application and named appropriately
  458. (with a *.set or *.ini extension, for example).
  459.  
  460. NOTE:  Two or more applications -can- share a single settings file.  If
  461.        you wish to do this, simply specify the full pathname to the
  462.        settings file in the settings: entry field.  There will be no
  463.        need to click the settings button (the settings are already
  464.        defined).
  465.  
  466. Once a filename is entered into the Settings: entry field, you can
  467. click the settings button to edit those settings.   Editing DOS
  468. settings is just like editing DOS settings under Warp.  See the IBM
  469. OS/2 documentation for more information.
  470.  
  471.  
  472. SPECIAL NOTE:  If you are unsure how to set up a specific application, 
  473.                please look at the SAMPLE1.INI and SAMPLE2.INI files 
  474.                provided with FileBar.  They can serve as good examples 
  475.                as how to set up different applications.
  476.  
  477.      
  478. -------------------------------------------------------------------------------
  479.  
  480. == FILEBAR OPTIONS ===============
  481.  
  482. FileBar has many options that be configured by you.  Selecting the Options
  483. item from the FileBar menu will present a list of seven different options
  484. areas that you can modify.  They are each presented below.  Settings values
  485. are saved when you save your configuration file.  It is suggested that you
  486. select Save from the FileBar menu after making option changes.
  487.  
  488.    GENERAL:  FileBar's general options are set here.  You may choose to have
  489.          the bar at the top of the screen or at the bottom of the screen.
  490.          You may also choose whether the FileBar and Task List menus
  491.          are displayed in long form or short form.  You may set whether
  492.          if FileBar asks for confirmation before closing an application
  493.          from the task list or not.
  494.  
  495.          You can also set whether the WPS desktop (when present), is
  496.          resized so that when FileBar is at the top of the screen, it
  497.          does not cover any portion of the WPS.
  498.  
  499.          "Force on Top/Auto Resize" specifies whether your FileBar should
  500.          always float on top of all other running applications.  When 
  501.          turned on, FileBar will never be covered up by another 
  502.          application and it will resize applications who try to cover it
  503.          so they fit under it.
  504.  
  505.          Lockup on Startup will lock up the system when FileBar is started.
  506.              "Remove from task list when shell", if enabled, will remove
  507.              FileBar from the task list if it is acting as the replacement 
  508.              shell.  Do not check this item to keep it on the task list.
  509.  
  510.    WORK AREAS:  Options concerning the virtual work areas are set here.  The
  511.         first option, "Enable virtual work areas", is to decide if
  512.         you want to use the virtual work areas feature at all.
  513.         
  514.                 If you are using virtual work areas and you want your
  515.         Warp WPS launchpad to be present in all virtual work areas,
  516.         select the second option.  Note that your launchpad must be
  517.                 named "LaunchPad" on the General page in the LaunchPad
  518.                 settings notebook for this to work properly.
  519.                 
  520.                 Also, if you would like to use the 3x3 button pad to help 
  521.                 you select virtual work areas, select the 3rd option.  You 
  522.                 can also select the arrangement for the virtual work area
  523.                 control box.  It can be aligned in a 3x3 grid, a horizontal
  524.                 row or a vertical row.
  525.  
  526.    TIME/DATE:  This option dialog allows you set the style and format of the
  527.            time and date that appears on the far right side of your 
  528.            FileBar.  You may also enable or disable an hourly chime
  529.            feature in FileBar.  If enabled, you may enter the complete
  530.            path to a .WAV sound file to play at the top of each hour.
  531.            You may also use the Find .WAV File button to help you locate
  532.            a .WAV file to use.  Selecting Test Chime will play the
  533.            .WAV file specified in the entry field.
  534.    
  535.    POP-UP MENU:  In addition to the menubar that is positioned at the top or 
  536.          bottom of your screen, you can also define FileBar to act
  537.          as a pop-up menu when a specified mouse button combination
  538.          is pressed.  
  539.  
  540.          The first option is whether or not to enable the pop-up
  541.          menu feature, at all.  Selecting "Hide Primary FileBar
  542.          Menu" will hide the main FileBar menu.  If you use this
  543.          option, you must use the mouse-button combination to summon
  544.          the FileBar menu.  Using this behavior, with FileBar as your
  545.          replacement shell, causes your OS/2 to act more like a
  546.          X Window display station with a pop-up root menu.
  547.  
  548.          The third option, "Pop-up over any window", deicdes whether
  549.          the FileBar pop-up can be summoned over any window or if it
  550.          should be allowed -only- over the background window.
  551.  
  552.    SYSTEM ADMINISTRATION:  FileBar has the facility to allow primary FileBar
  553.                functions to be protected by password.  This is
  554.                called the System Administration Password.  If you
  555.                wish primary FileBar functions to be protected,
  556.                select the protection check box.  If you wish
  557.                to set the password used, click the "Change
  558.                Password" button.  
  559.  
  560.                This feature will not protect user items from
  561.                being selected.  That is set via the passwording
  562.                options for each menu item.  Please refer to the
  563.                section on editting menu items for more 
  564.                information.
  565.                
  566.                This feature can be used to help make a secure
  567.                system.  You can lock out all FileBar functions
  568.                and then password protect menu items and provide
  569.                users limited access to your system.
  570.                
  571.                Remember, your default password is "filebar" (all
  572.                in lower case!).  While you should change it from
  573.                that if you use it, that is the password used when
  574.                you use the sample .INI file.
  575.  
  576.    STARTUP LIST:  This dialog allows you the specify the starting order for
  577.           any items you may have flagged as needing to be started
  578.           whenever FileBar starts.  You may move items up and down
  579.           in the starting order; items at the top of the list launch
  580.           before items at the bottom.  You may also remove items from
  581.           the startup list here, too.
  582.  
  583.           The "Launch Startup List on Boot" enables all the items on
  584.           the startup list to be launched everytime FileBar starts.
  585.           The "Launch only if shell replacement" feature launches
  586.           your startup list (if Launch on Boot is enabled), if and
  587.           only if FileBar is acting as your shell.
  588.  
  589.    BACKGROUND:  This options defined in this dialog take effect only when
  590.         FileBar is your shell.  It does not override the background
  591.         settings when you are using FileBar in conjunction with the
  592.         WPS.  If FileBar is your replacement shell, you may specify
  593.         if you want the background to be a solid color or a bitmap.
  594.         If you wish it to be a color, you may alter its shade by
  595.         moving the red, green and blue components of it.
  596.  
  597.         If you wish to use a background image, enter the name of the
  598.         image in the entry field and select the style of how you 
  599.         want the image presented.  Just like the WPS, only .BMP 
  600.         images may be used as background bitmaps.
  601.  
  602.         NOTE!!!  There is a problem with IBM Warp v3.0 that the
  603.         background feature does NOT work for bitmap images!  This is
  604.         a problem in Warp and NOT in FileBar.  IBM is aware of this
  605.         problem (IBM PMR #: 4X472) and is working on it.  Future 
  606.         versions of Warp should work but v3.0 does not!
  607.  
  608.  
  609. -------------------------------------------------------------------------------
  610.  
  611. == TIPS, SHORT CUTS and MISC ITEMS ===============================
  612.  
  613. For various features in FileBar, there exist "short cuts" that allow to
  614. access certain features with a fewer than usual number of steps.  These
  615. short cuts, some tips and techniques and other misc. topics are listed
  616. below:
  617.  
  618. *  CTRL+SPACE is a global hotkey that gives focus to FileBar.  Pressing
  619.    this key combination in any application will immediately cause FileBar
  620.    to become active.
  621.  
  622. *  If you are using virtual work areas and you have chosen that you want
  623.    your Warp WPS launchpad to be present in all virtual work areas,
  624.    remember that your launchpad must be named "LaunchPad".  This is set
  625.    on the General page in the LaunchPad settings notebook.
  626.  
  627. *  Your desktop must be named "Desktop", also, for your WPS background to
  628.    be present in ALL virtual work areas.  You can verify its name by
  629.    checking the general page for the desktop settings notebook.
  630.  
  631. *  When starting FileBar, and running OS/2 Warp, it accepts a command line 
  632.    parameter, if specified.  You may launch FileBar with the optional name 
  633.    of the initialization file you wish to use with it by specifying it on 
  634.    the command line.
  635.  
  636.    For example, to use FileBar as your replacement shell when FileBar is
  637.    in C:\OS2\APPS\FILEBAR and OS/2 is on drive D: and the configuration file
  638.    is E:\OS2\FB_INIT\SAMPLE.INI, then you would modify your OS/2 config.sys 
  639.    (on drive D:) to read:
  640.  
  641.    SET RUNWORKPLACE=C:\OS2\APPS\FILEBAR\FILEBAR.EXE E:\OS2\FB_INIT\SAMPLE.INI
  642.  
  643.    or, you may start FileBar from the command line with the same parameter:
  644.  
  645.    start C:\OS2\APPS\FILEBAR\FILEBAR.EXE E:\OS2\FB_INIT\SAMPLE.INI 
  646.  
  647. *  You may edit individual menu items by holding the right mouse button over
  648.    a menu, sliding the mouse down to the specified item and release the right
  649.    mouse button over it.
  650.  
  651. *  You may switch virtual work areas (screens) by holding the CTRL keyy and 
  652.    by pressing a number 1 through 9.
  653.  
  654. *  You can select items in a list box in various dialogs by double clicking 
  655.    the desired list box item.
  656.  
  657. *  You may move the virtual winows selector box by holding the right
  658.    mouse button over the window and drag the window to a new location.
  659.  
  660. *  Remember, your default password is filebar (7 letters, all lowercase!)
  661.  
  662. *  Also remember that if you are using the password protection system, be sure
  663.    to change your passwords frequently and that you keep your FILEBAR2.INI 
  664.    file out of view from anyone (passwords are stored in that file).
  665.  
  666. *  If you would like to set up the VIEW command (to view the OS/2 command
  667.    reference or other .INF materials), the program path field in the item
  668.    settings should be set to VIEW.EXE and the argument field should point
  669.    to the .INF you would like to view (ie: D:\OS2\BOOK\CMDREF.INF)
  670.  
  671. *  When entering command line parameters, you can specify that some or all of
  672.    the options be entered when the program is started.  If you enclose one
  673.    or parameters in brackets ('[' and ']') then FileBar will prompt you to 
  674.    enter the parameter(s) when the item is launched.
  675.  
  676. *  You may drag a font to the FileBar (from the Font Palette) if you wish
  677.    to change the font FileBar uses for its menus.  After you drop a font,
  678.    the menu bar will change to accomdate this new font.  The font you drop
  679.    will be remembered next time you start FileBar.  If you find yourself
  680.    running out of room on your menubar because you are using long menu names,
  681.    simply drag and drop a smaller font to FileBar (from the font palette in
  682.    the OS/2 system folder).
  683.  
  684. *  If the time is not displayed (but you have the option under Time/Date
  685.    options set to display a time/date), you probably need a smaller font.
  686.    If there is not enough room for the entire time and/or date, OS/2 will
  687.    simply not display it.
  688.  
  689. *  You may also drag colors (or schemes) to FileBar from the color or scheme
  690.    palettes that come with OS/2.
  691.  
  692. *  You may use the tilde (~) in your menu and item names to signify that the
  693.    character immediately following the tilde should be used as an
  694.    accelerator for accessing the respective menus or items.
  695.  
  696. *  All changes made (time/date, bar position, menu contents, etc.) are saved
  697.    each time FileBar is closed (or the system is shutdown or an explicit save
  698.    operation is requested).  FileBar is restored to the state it was saved in
  699.    next time it is executed.  Changes are saved ONLY during these times.
  700.  
  701. *  When editing menu items, you can drag WPS objects to the "drop area"
  702.    and FileBar will open that object when you select that item.
  703.  
  704. *  When using FileBar as a WPS replacement, WPS features such as folders and
  705.    program objects are no longer functional.  Please remember this if you are
  706.    trying to open a WPS folder via FileBar when FileBar has replaced the WPS.
  707.  
  708. *  The configuration information for the FileBar is stored in a file named
  709.    FILEBAR2.INI (in the directory where FILEBAR.EXE is located) and may be
  710.    backed up by the user for added protection.  It is a strictly text file
  711.    and may be backed up by copying a valid FILEBAR2.INI file to another, 
  712.    unused filename (ie: COPY FILEBAR2.INI BACKUP.INI).
  713.     
  714.        -- It is recommended that you make a backup copy of --
  715.             your FILEBAR2.INI on a regular basis!
  716.  
  717. *  FileBar comes with two sample FileBar configurations, SAMPLE1.INI and
  718.    SAMPLE2.INI.  To try these out, copy one of them over your FileBar .INI
  719.    file (ie: COPY SAMPLE1.INI FILEBAR2.INI).  NOTE!  This will overwrite your
  720.    current FileBar configuration and destroy the contents it currently has.
  721.    These contain samples for how to launch DOS windowed and full screen 
  722.    sessions, OS/2 windowed and full screen sessions, and Win-OS/2 windowed
  723.    and full screen sessions, among other things.  Refer to these for tips on
  724.    how to set up your own FileBar!
  725.  
  726. *  If you wish to add items that launch OS/2 command shells (DOS windows,
  727.    DOS full-screens, WIN-OS2 sessions, etc.), see the SAMPLE1 or SAMPLE2
  728.    .INI files.  For OS/2 and DOS sessions, simply select what type of command
  729.    shell you would like (from application type section) and then leave the
  730.    Program Path empty.  That will start a command shell (DOS window, DOS
  731.    fullscreen, OS/2 window, and OS/2 fullscreen sessions).
  732.    
  733.    However, if you want to start a WINOS/2 windowed session, put PROGMAN.EXE
  734.    in the program path (it will start program manager for you).  Again, see
  735.    the SAMPLE1.INI or SAMPLE2.INI files for specific details.
  736.  
  737. *  Two or more DOS or Windows applications CAN share settings information.
  738.    For the first application, you will need to enter a unique pathname and
  739.    set the settings information.  For all subsequent applications you want
  740.    to use this information, simply enter that same pathname into their
  741.    settings: entry fields as well (on the edit individual menu item dialog).
  742.  
  743.    Using this idea, you can make a couple of general settings files that
  744.    may come in handy for a number of applications.  For example, you can
  745.    make a "DOS_GAME.INI" DOS settings file.  This settings file could be
  746.    set up with games in mind and referenced by all your DOS games.  This
  747.    way, you would only need to specify the settings once!!
  748.  
  749.  
  750. -------------------------------------------------------------------------------
  751.  
  752. == COMMON QUESTIONS ================
  753.  
  754. Q.  How can I set the font and colors FileBar uses?
  755. A.  You can drag and drop both schemes (and/or colors) and fonts onto FileBar 
  756.     from the WPS.  You need to run FileBar as a regular application, do any
  757.     color or font adjustments you need to, and then either continue to run
  758.     FileBar or configure FileBar to run as your shell (explained in the
  759.     installation section at the top of this file).  All changes you make
  760.     will be remembered the next you start FileBar.
  761.  
  762. Q.  My FileBar flashes sometimes when the time changes?  What's wrong?
  763. A.  Nothing is wrong.  IBM decided that OS/2 should redraw the entire menu
  764.     bar when a single menu item's text changes.  There is nothing that can
  765.     be done.
  766.  
  767. Q.  My time and date is gone.  After I added a few menu items and now it is 
  768.     no longer displayed.  Where is it?  How can I get it back?
  769. A.  It is not displayed when there is not ample room on the menubar to
  770.     adequetly display it.  You need to drag and drop a smaller font to the
  771.     FileBar menu.  Go to the OS/2 Font Palette and select a smaller font
  772.     (as described in your OS/2 documentation).  Now, drag and drop this
  773.     font to FileBar.  The change will be remembered whenever FileBar is
  774.     started.
  775.  
  776. Q.  Wow!  With FileBar, things are a lot faster.  But what else can I do to 
  777.     get more memory back for my applications to run in?
  778. A.  FileBar is a great start.  You are saving a lot of memory already.
  779.     However, if you are trying to get the most memory possible out of your 
  780.     computer, you probably should refrain from using the background bitmap 
  781.     option (found in both the WPS and FileBar).  Most backgrounds, while nice 
  782.     to look at, use a good deal of memory.  You can usually save quite a bit 
  783.     of memory when not using this option.
  784.  
  785.     Also, you may want to look into tuning your disk cache, eliminating 
  786.     unnecessary drivers, using OS/2 native applications versus Windows 
  787.     applications and much more.  There are a number of good shareware or
  788.     freeware sources for this type of information as well as a number of
  789.     good commercial software and books.
  790.  
  791. Q.  I have a configuration file from FileBar 1.90.  How can I use it with the
  792.     new FileBar?
  793. A.  You can't.  With the rewriting of FileBar, great care was taken to rewrite
  794.     the saving and loading mechanism so that it is very stable and very
  795.     reliable.  With the drastic changes that took place, it is not possible
  796.     to use your older configuration files.  You will need to recreate your
  797.     menu structure.  
  798.  
  799.     FileBar 2.xx's configuration file format is highly extensible, however.
  800.     Unlike the 1.xx releases, it allows easy future expansion and you should
  801.     not have this problem in the future.
  802.  
  803. Q.  I registered version 1.80 of FileBar.  Why do I need to register this
  804.     one, too?
  805. A.  The registration fee for all FileBar software prior to release 2.00
  806.     was $10.00 AND included the source code that generated it.  With release
  807.     2.00, the source code was removed from the archive and the fee was
  808.     increased.  $10.00 simply did not cover the costs of the time and
  809.     development that goes into developing and maintaining this application.  
  810.     Version 2.00 is a complete rewrite of FileBar.  FileBar is now MUCH
  811.     more stable and handles memory in a much cleaner way.  It also adds
  812.     a good number of new features.  Because of this, and my continued
  813.     efforts and development planned for FileBar, I feel justified in this
  814.     decision.
  815.  
  816.     Many, many users wrote saying I could easily get $60 to $80 for an 
  817.     application of this type.  Wanting to keep the software affordable, 
  818.     however, I opted to set up the pricing structure as I did.  (Keeping
  819.     it affordable!)
  820.  
  821.     (Registered users are still getting a discount on the new upgrade price.)
  822.  
  823.     Source code is available for this product for an additional charge.
  824.     Contact technical support to find out more details.
  825.  
  826.  
  827. -------------------------------------------------------------------------------
  828.  
  829. == Registration ============
  830.  
  831. If you like FileBar and plan to continue to use it, I ask you to register 
  832. your copy of the program.  The registration cost is only $15.00 for
  833. users who have registered previous versions of FileBar and $25.00 for new 
  834. FileBar users.  
  835.  
  836. Upon registration, you will be sent a registration certificate.  To 
  837. complete your registration, you will need to enter the information found on
  838. this certificate into FileBar.  Start FileBar and select the About...
  839. option.  Click OK to dismiss the informational dialog.  Now, enter the
  840. name, place and serial # into the appropriate fields EXACTLY as shown
  841. into the entry fields.  Once you are done, click Register Now and that's it!!
  842. You're done!  Please keep your registration certificate in a safe place in
  843. case you need to re-enter this information.  You registration entitles you
  844. to all future 2.xx releases.  (See "Updates" section below)
  845.  
  846. Please see the enclosed ORDER.TXT form for more complete details.  Orders
  847. can be placed by mail, fax, phone or computer.  All major credit cards are
  848. accepted and international orders are welcome.  Please print it out the
  849. ORDER.TXT form, fill it out and send it with your payment to the address 
  850. given on that form.  THANK YOU!
  851.  
  852. -------------------------------------------------------------------------------
  853.  
  854. == Updates to FileBar ==================
  855.  
  856. As updates to FileBar 2.xx are made, they will be released publically over
  857. an array of distribution channels.  These include shareware CDs, BBSes,
  858. BMT Micro's BBS, the Internet, CompuServe, Delphi, America Online, etc.  
  859. Announcements will also be made along similar channels to alert users to its 
  860. availability.
  861.  
  862. Once you register, the registration information you receive will unlock
  863. ALL 2.xx versions of FileBar.  Remember to keep that information in a safe
  864. place when you receive it after registering.
  865.  
  866.  
  867. -------------------------------------------------------------------------------
  868.  
  869. == Distribution of FileBar ========================
  870.  
  871. You are free to distribute FileBar to whomever and however you wish as long
  872. as the following conditions are satisified:
  873.  
  874.   -  FileBar should ALWAYS be distributed in its entirety.  This includes
  875.      all documentation, executables, and setup files.  Under no circumstances
  876.      should FileBar be distributed without all of its original files.
  877.      Distribution of FileBar (in any way possible!) is strongly encouraged
  878.      both by individuals and software houses!
  879.  
  880.   -  If you use FileBar, you MUST register it (directions for doing so
  881.      preceeded this section of the text).  Upon registration, you will
  882.      receive information that you can enter into FileBar to unlock it and
  883.      make it a full version.
  884.  
  885.   HOWEVER!  Once you register FileBar and receive your registration 
  886.         information, you may NOT share your registration information
  887.         with anyone!  
  888.      
  889.